home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #11 / Amiga Plus CD - 2002 - No. 11.iso / Tools / Freeware / Remapollo / RemAPollo.doc.pl < prev    next >
Encoding:
Text File  |  2002-10-27  |  31.4 KB  |  738 lines
  1.                                 RemAPollo V1.7
  2.  
  3.                        Produkt Eccentric Creations (TM)
  4.  
  5.                  (c) Mikoîaj Caîusiïski 1998-2002. Freeware.
  6.  
  7.                              Instrukcja obsîugi.
  8.  
  9. Wstëp
  10. -----
  11.  
  12. RemAPollo - 040\060 MMU Apollo Turboboard Remapper jest pakietem freeware
  13. (uûywanie go nie wymaga rejestracji ani ûadnych opîat), ale autor zastrzega
  14. sobie wszystkie prawa autorskie. Pakiet zostaî napisany pod wpîywem mojej
  15. rozpaczy, wynikajâcej z braku moûliwoôci podmiany Kickstartu przez
  16. uûytkowników kart Apollo. My, posiadacze tychûe kart byliômy w gorszej
  17. sytuacji, niû wîaôciciele kart typu Blizzard, którzy mogli w dziecinnie prosty
  18. sposób (ustawiajâc jednâ zworkë na karcie) "podmieniê" sobie ROM. My nie
  19. moûemy tego zrobiê - nasze karty nie posiadajâ takich zworek, dodatkowo nie
  20. byîo dotychczas programów umoûliwiajâcych nam takâ operacjë w sposób czysto
  21. programowy. Mam nadziejë, ûe ta nierównoôê zostanie niniejszym wyrównana przez
  22. RemAPollo.
  23.  
  24. Zwróê uwagë, ûe chociaû RemAPollo nie jest juû w fazie beta testów, to nie
  25. musi to wcale oznaczaê, ûe jest pozbawiony wszelkich bîëdów. Jeûeli wykryjesz
  26. jakiekolwiek nieprawidîowoôci w dziaîaniu programu, skontaktuj sië ze mnâ;
  27. szczegóîowe opisy bîëdów mile widziane. Mój adres znajdziesz w rozdziale
  28. "Autor". Ponadto upewnij sië, ûe uwaûnie przeczytaîeô të instrukcjë!
  29.  
  30. Rozpowszechnianie
  31. -----------------
  32.  
  33. Pakiet RemAPollo moûe byê swobodnie rozpowszechniany, przy uwzglëdnieniu
  34. poniûszych kryteriów:
  35.  
  36.  - Ûaden z plików, wchodzâcych w skîad pakietu nie moûe byê modyfikowany, ani
  37.    pominiëty.
  38.  
  39.  - Nie moûna pobieraê ûadnych opîat za pakiet, z wyjâtkiem kosztu noônika i
  40.    opîat manipulacyjnych.
  41.  
  42.  - Pakiet RemAPollo moûe byê doîâczany do zestawów darmowego oprogramowania,
  43.    ale nie moûe byê zamieszczany na komercyjnych pîytach CD-ROM (wîâczajâc w
  44.    to pîyty doîâczane do czasopism tzw. coverdyski). Jeûeli chesz zamieôciê
  45.    ten pakiet na swoim CD-ROMie musisz najpierw zwróciê sië do mnie o
  46.    wyraûenie zgody. Powyûsze nie dotyczy pîyt AminetCD; Administrator Aminetu,
  47.    Urban MÜller, ma mojâ zgodë na umieszczanie pakietu RemAPollo na tychûe
  48.    pîytach.
  49.  
  50.  - Pakiet RemAPollo nie moûe byê doîâczany do jakiegokolwiek komercyjnego
  51.    produktu, bez mojej pisemnej zgody.
  52.  
  53. Ostrzeûenie
  54. -----------
  55.  
  56. UÛYWASZ PLIKÓW, WCHODZÂCYCH W SKÎAD PAKIETU RemAPollo CAÎKOWICIE NA WÎASNE
  57. RYZYKO. NIE PONOSZË ÛADNEJ ODPOWIEDZIALNOÔCI ZA SZKODY SPOWODOWANE
  58. UÛYTKOWANIEM TEGO PAKIETU!
  59.  
  60. Do czego to wîaôciwie sîuûy?
  61. ----------------------------
  62.  
  63. RemAPollo jest pakietem programów stworzonych dla uûytkowników komputera Amiga
  64. 1200, wyposaûonego w kartë turbo Apollo 040/060. W jego skîad wchodzi kilka
  65. plików sîuûâcych do podmieniania Kickstartu - czëôci systemu operacyjnego
  66. Amigi, znajdujâcej sië w ROMie. Moûesz przenieôê Kickstart, który masz
  67. zapisany w ROMie do szybkiej pamiëci, bâdú teû uûyê zupeînie innej wersji
  68. Kickstartu (szczególnie przydatne, gdy jesteô programistâ). Wiëcej szczegóîów
  69. w rozdziale "Korzystanie z pakietu".
  70.  
  71. Pliki pakietu
  72. -------------
  73.  
  74. Pakiet RemAPollo skîada sië z nastëpujâcych plików
  75.  
  76. - 68060.pch - îatka uaktualniajâca bibliotekë 68060 w wersji 60.02 do 60.10
  77.  
  78. - Converter - komenda umoûliwiajâca konwersjë moduîów BlizKicka (typu
  79.   extresbuf) na format zrozumiaîy dla RemAPollo.
  80.  
  81. - CopyIDEfixPrefs - programik dla uûytkowników pakietu IDEfix - sîuûy do
  82.   kopiowania preferencji z zewnëtrznego pliku do pliku komendy IDEfix.
  83.   Powinien byê uûyty przez uûytkowników chcâcych zaîadowaê IDEfixa poprzez
  84.   opcjë MODULES mapera
  85.  
  86. - DRAP - Apollo Remapper Deallocator
  87.  
  88. - ExecP - îatka na moduî exec.library z BoingBag 2 dla OS3.9 - ustawia
  89.   poprawny numer rewizji Kickstartu (który pojawia sië np. po wybraniu menu
  90.   About z WB)
  91.  
  92. - FakeLOCAL - ta komenda ustawia atrybut LOCAL (na Kickstarcie 3.x równieû bit
  93.   KICK) dla pamiëci fast karty Apollo. Dziëki temu wiëkszoôê programów
  94.   rezydentnych zostaje zainstalowana w pamiëci fast zamiast chip. UWAGA!
  95.   Poniewaû ustawienie tych bitów przez uûytkownika jest nielegalne (powinna to
  96.   byê wyîâcznie domena systemu), program ten jest przeznaczony tylko dla
  97.   zaawansowanych uûytkowników! Uûywaj tylko razem z programem RemAPollo i
  98.   tylko jeôli wiesz, co robisz!
  99.  
  100. - KReader - krótka komenda do zgrywania Kicstartu do pliku ram:Kickstart.
  101.   Uûywaj razem z opcjâ 'F' jeôli chcesz mieê pewnoôê, ûe zostanie zgrany
  102.   oryginalny ROM z koôci.
  103.  
  104. - LoadResident - komenda CLI, która sîuûy do odawania/usuwania lub
  105.   wyôwietlania listy moduîów rezydentnych bez koniecznoôci ponownego
  106.   uruchamiania programu RemAPollo.
  107.  
  108. - Modules/fixramlib - moduî ten poprawia bîâd w ramlibie, uniemoûliwiajâcy
  109.   pracë moduîów AFTERDOS na KS 2.x (np. HappyENV-handler). W przypadku
  110.   Kickstartu 3.x jego uûycie jest zbëdne
  111.  
  112. - Modules/fixramlib.s - kod úródîowy do tego moduîu
  113.  
  114. - Modules/HappyConfig - specjalny programik umoûliwiajâcy podanie dodatkowych
  115.   opcji dla moduîu HappyENV-handler przy îadowaniu rezydentnym. Posiada
  116.   nastëpujâce opcje: 'HappyENV-handler,TO,STARTUP/K/F:', gdzie: pierwszy
  117.   argument okreôla ôcieûkë dostëpu do moduîu HappyENV-handler (domyôlnie w
  118.   L:), TO okreôla nazwë zmodyfikowanego handlera, a sîowo kluczowe STARTUP
  119.   sîuûy do podania dodatkowych opcji. Peînâ listë dostëpnych opcji moûesz
  120.   znaleúê w oryginalnej instrukcji do pakietu HappyENV. W celu usuniëcia
  121.   wszystkich opcji uruchom programik bez parametru STARTUP. Przykîady:
  122.   'HappyConfig STARTUP NOREQ' - konfiguruje handler w tryb ignorowania
  123.   nierozpoznanych/nieobsîîugiwanych pakietów
  124.   'HappyConfig' - usuwa wszystkie opcje
  125.  
  126. - Modules/HappyENV-handler - poprawiona wersja tego znanego handlera,
  127.   oryginalnie autorstwa Martina Giericha, w wersji 1.3, umoûliwiajâca
  128.   rezydentnâ instalacjë
  129.  
  130. - Modules/KingCON-handler.pch - îatka na KingCON-handler 1.3, w wersji 020+,
  131.   umoûliwiajâca jego rezydentne zaîadowanie (dziëki czemu caîkowicie zastëpuje
  132.   on systemowy con-handler)
  133.  
  134. - Modules/MountENV - poprawiona wersja komendy MountENV
  135.  
  136. - Modules/noclick - uaktualniona wersja moduîu BlizKicka, który sîuûy do
  137.   wyîâczania "klikania" stacji dysków
  138.  
  139. - Modules/noclick.s - kod úródîowy do tego moduîu
  140.  
  141. - MuDRAP - Apollo Remapper Deallocator przeznaczony do uûycia z bibliotekâ
  142.   68040/060 z pakietu mmu.library
  143.  
  144. - patch - programik do aktualizacji biblioteki 6804(6)0
  145.  
  146. - RemAPollo - gîówny program remapujâcy
  147.  
  148. - RemAPollo.doc - angielska wersja dokumentacji
  149.  
  150. - RemAPollo.doc.info
  151.  
  152. - RemAPollo.doc.pl - niniejszy tekst
  153.  
  154. - RemAPollo.doc.pl.info
  155.  
  156. - RemAPollo.info - fajna ikonka
  157.  
  158. - RemAPollo.readme - krótki opis dla Aminetu
  159.  
  160. - Reset - programik resetujâcy
  161.  
  162. - RUX - OS3.5/3.9 ROM Update eXtractor - komenda ulatwiajaca instalacje
  163.   systemu 3.5/3.9, z zachowaniem jednego resetu na starcie komputera (patrz
  164.   teû rozdziaî "Informacje dodatkowe")
  165.  
  166. Prawa autorskie
  167. ---------------
  168.  
  169. Amiga, AmigaOS and Kickstart - Copyright © 1985-1999 Amiga International,
  170. Inc.
  171. BlizKick - Copyright © 1996-2000 PitPlane Productions.
  172. Fusion - Copyright ©1997 By Jim Drew & Microcode Solutions
  173. HappyENV-handler - Copyright 1995-1997 Martin Gierich
  174. IDEfix - Copyright 1993 - 1999 Elaborate Bytes, Oliver Kastl.
  175. KingCON-handler - Copyright © 1993,1994 David Larsson
  176. mmu.library project © 1998-2000 the mmu.library development group, THOR
  177. RemAPollo - Copyright © 1998-2000 Mikoîaj Caîusiïski.
  178. ShapeShifter - © Copyright 1993-1999 Christian Bauer.
  179. spatch - Copyright © 1992 SAS Institute, Inc.
  180.  
  181. Wymagania
  182. ---------
  183.  
  184. Dla poprawnego dziaîania pakietu sâ wymagane: 
  185.  
  186. - komputer Amiga 1200 lub 4000
  187.  
  188. - przynajmniej wersja 2.0 (V36) systemu operacyjnego (to chyba nie jest
  189.   problem :-)
  190.  
  191. - karta turbo Apollo 040 lub 060 (procesor musi posiadaê sprawny MMU),
  192.   wyposaûona w przynajmniej 1 MB pamiëci fast
  193.  
  194. - oryginalna biblioteka 040.library pochodzâca z Commodore w wersjach 37.10
  195.   lub 37.30 (lub 44.2 z OS3.5), jeûeli uûywasz procesora 68040 albo biblioteka
  196.   060.library doîâczana do karty turbo (obecnie program wspóîpracuje tylko z
  197.   wersjâ 60.10), jeûeli uûywasz procesora 68060.
  198.  
  199.  
  200. Instalacja
  201. ----------
  202.  
  203. Instalacja, jakkolwiek prosta, skîada sië z kilku czynnoôci, które powinny byê
  204. wykonane starannie i uwaûnie, w przeciwnym razie system prawie na pewno bëdzie
  205. sprawiaî problemy. Poniewaû RemAPollo nie jest przeznaczony dla
  206. niedoôwiadczonych uûytkowników, w pakiecie nie ma skryptu instalacyjnego -
  207. caîâ pracë musisz wykonaê rëcznie.
  208.  
  209.                                       1.
  210.  
  211. Najpierw - to bardzo waûne - powinieneô zaktualizowaê plik 040(060).library. W
  212. archiwum z programem znajdziesz specjalny program "patch" do tego celu. Jeûeli
  213. Twoja 040(060).library znajduje sië w katalogu LIBS: i nie zostaîa spakowana,
  214. wystarczy jedynie uruchomiê program "patch" bez ûadnych parametrów. Program
  215. poinformuje Cië o wyniku swojej pracy, niestety tylko po angielsku. UWAGA! W
  216. przypadku procesora 68040 upewnij sië, ûe uûywana przez Ciebie 040.library
  217. pochodzi z Commodore; jeûeli wykorzystujesz bibliotekë pochodzâcâ z innych
  218. úródeî (np. z Phase5) musisz z niej zrezygnowaê. W szczególnoôci remaper nie
  219. bëdzie wspóîpracowaî z bibliotekami Phase5; ich uûywanie nie wpîywa na lepsze
  220. funkcjonowanie kart Apollo.
  221.  
  222. Jeôli Twoja biblioteka jest spakowana, najpierw rozpakuj jâ, a nastëpnie
  223. wywoîaj program "patch" podajâc ôcieûkë dostëpu do niej. Po skoïczonej
  224. operacji moûesz spakowaê bibliotekë ponownie.
  225.  
  226. Powyûsza czynnoôê jest ABSOLUTNIE konieczna, dla prawidîowej pracy systemu z
  227. podmienionym Kickstartem. Twoja Amiga moûe dziaîaê poprawnie bez dokonywania
  228. zmian w pliku 040(060).library, ale nie wprowadzajâc ich sam prosisz sië o
  229. kîopoty; za którymô razem system moûe sië "zawiesiê". Jeûeli chcesz dowiedzieê
  230. sië czegoô wiëcej o zmianach wykonywanych przez program "patch" przeczytaj
  231. rozdiaî "Informacje dodatkowe".
  232.  
  233. Niektóre starsze wersje kart Apollo z procesorem 060, posiadajâ doîâczonâ
  234. bibliotekë 68060 w wersji 60.02, z którâ nie wspóîpracuje programik "patch"
  235. (który wymaga biblioteki w wersji 60.10). Specjalnie dla uûytkowników takich
  236. kart, doîâczyîem specjalnâ îatkë uaktualniajâcâ 68060.library do wersji 60.10.
  237. Aby jâ wykorzystaê, uûyj powszechnie dostëpnego programiku "spatch".
  238.  
  239.                                       2.
  240.  
  241. Po zakoïczeniu operacji uaktualniania biblioteki powinieneô skopiowaê program
  242. DRAP (Apollo Remapper Deallocator) do katalogu C:. Do wersji 1.11 wîâcznie,
  243. wywoîanie DRAPa musiaîo nastâpiê po komendzie SetPatch; poczâwszy od wersji
  244. 1.12 nie jest to konieczne. Obecnie zaleca sië umieszczenie DRAPa jako
  245. pierwsza komenda w startupie. Odpowiedni fragment Twojego startup-sequence
  246. moûe wyglâdaê tak:
  247.  
  248. ...
  249. DRAP
  250. If WARN
  251. RemAPollo MAC QUIET
  252. EndIf
  253. SetPatch QUIET
  254. ...
  255.  
  256. Stosowanie tego programiku nie jest wymagane dla poprawnego funkcjonowania
  257. relokacji, ale jego uûycie jest ze wszech miar polecane. Jego dziaîanie polega
  258. m.in. na zwolnieniu pamiëci alokowanej przez remaper (dokîadnie 67712
  259. bajtów) i doprowadzeniu systemu do bardziej efektywnego i stabilnego stanu.
  260. Jeûeli zamierzasz korzystaê z funkcji MAC (patrz rozdziaî "Korzystanie z
  261. pakietu") ten program *MUSI* zostaê uruchomiony, w przeciwnym razie emulator
  262. "zawiesi" sië. Uûywanie DRAPa przyspieszy teû nieco pracë systemu, poniewaû
  263. przenosi pierwszâ stronë pamiëci (pierwsze 4kb) z wooolnej pamiëci chip do
  264. pamiëci fast. Wreszcie, zabezpieczy on zmapowany Kickstart przed zapisem.
  265. Moûesz umieôciê DRAPa w startup-sequence na staîe - w przypadku nie wykrycia
  266. relokacji nie robi on nic, z wyjâtkiem ustawienia kodu wyjôciowego (RC) na 5.
  267.  
  268. Od wersji 1.8 DRAPa istnieje moûliwoôê pewnej jego konfiguracji, jednak
  269. zalecane jest wywoîywanie DRAPa tak, jak dotychczas (bez ûadnych parametrów).
  270. Nowe parametry to: ND (lub NODEALLOC) oraz RH (lub RESTOREHANDLER).
  271.  
  272. Pierwszy wstrzymuje dealokacje pamiëci (67720 bajtów) uûywanej na tabele MMU.
  273. Tabele te nie sâ potrzebne, jak tylko 68040.library zostanie zainstalowana w
  274. systemie, wiëc w wiëkszoôci przypadków nie powinno sië wywoîywaê tego
  275. przeîâcznika. Jeôli jednak chcesz korzystaê ze statram.device (SDx:) lub masz
  276. problemy ze úle napisanymi programami rezydentnymi (np. SIMBug), powinieneô
  277. wîâczyê NODEALLOC. Bëdziesz miaî mniej pamiëci (67720 bajtów) ale SD0 bëdzie
  278. pracowaê jak powinno.
  279.  
  280. Drugi parametr (RESTOREHANDLER) wymusza odtworzenie oryginalnej wartoôci
  281. wektora Bus-Error, tak, jak w poprzedniej wersji remapera. Nie jest to
  282. polecane, poniewaû spowoduje zawieszenie sië komputera (o ile nie jest
  283. uruchomiony Enforcer) po zapisie w obszar ROMu.
  284.  
  285. Od wersji 1.12 zostaîy wprowadzone drobne zmiany w kodzie inicjalizacyjnym
  286. DRAPa, dziëki czemu nie musi on juû byê uruchamiany po komendzie SetPatch -
  287. program teraz sam otwiera 68040\060.library. Wprowadzono teû nowy parametr NR
  288. (NOREMAP), który wyîâcza domyôlne remapowanie tzw. zerowej strony pamiëci z
  289. chipu do fastu. Przy okazji poprawiono teû kompatybilnoôê tej operacji.
  290. Dodatkowe informacje moûesz znaleúê w sekcji Bîëdy. 
  291.  
  292.                                       3.
  293.  
  294. Kiedy powyûsze punkty zostanâ zrealizowane moûesz uûyê gîównego programu z
  295. pakietu (patrz rozdziaî "Korzystanie z pakietu").
  296.  
  297. Relokacja pozostanie aktywna tak dîugo, jak dîugo nie zostanâ naruszone: baza
  298. biblioteki exec ani wektor ColdCapture. Aby pozbyê sië jej z pamiëci uûyj
  299. zaîâczonego w pakiecie programu "Reset" z opcjâ HARD. Program ten wyczyôci
  300. lokacjë 4, usuwajâc z systemu wszelkie rezydenty.
  301.  
  302. Poczâwszy od wersji 1.6 RemAPollo istnieje bardziej wygodna metoda usuwania
  303. relokacji. Aby z niej skorzystaê, musisz uûywaê trójprzyciskowej myszki -
  304. wystarczy przytrzymaê MMB (ôrodkowy przycisk myszy) podczas resetu; ekran
  305. powinien przybraê barwë czerwonâ, a relokacja zostanie usuniëta.
  306.  
  307. Korzystanie z pakietu
  308. ---------------------
  309.  
  310. Gîówny program pakietu RemAPollo (o tej samej nazwie) moûe byê uruchomiony
  311. zarówno z CLI jak i z Workbencha. Tooltypy sâ praktycznie identyczne z
  312. parametrami CLI, w zwiâzku z czym omówimy tylko te ostatnie.
  313.  
  314. Standardowa skîadnia (uzyskiwania poprzez wpisanie "?" jako parametru) wyglâda
  315. tak:
  316.  
  317. KICKFILE,MAC/S,NF=NOPAGEFIX/S,REBFIX/S,IMJ/S,FORCE/S,QUIET/S,
  318. USE=USEKICKPTRS/S,MODULES/K/F:
  319.  
  320. Ûaden z parametrów nie jest wymagany. Jeûeli nie podasz wcale argumentów
  321. aktualny ROM zostanie zmapowany, a komputer wykona reset. Amiga zgîosi sië z
  322. tym samym Kickstartem co w ROMie, z jednâ niezwykle uûytecznâ róûnicâ: pamiëê
  323. fast jest przyîâczana w bardzo wczesnej fazie startu systemu (odpada
  324. koniecznoôê uûywania programów typu FastExec). Dziëki temu moûesz takûe
  325. zakîadaê dyski wirtualne RAD w pamiëci fast!
  326.  
  327. KICKFILE - ten parametr jest uûywany do zlokalizowania pliku z obrazem
  328. Kickstartu, którego chcesz uûywaê. Obsîugiwane sâ tylko Kickstarty 512kB,
  329. zawierajâce nagîówek $1114 lub 256KB z nagîówkiem $1111 i poprawnâ sumë
  330. kontrolnâ. Od wersji 1.4 RemAPollo wspóîpracuje z Kickstartami 1.x (256kB).
  331.  
  332. Od wersji 0.994 RemAPollo moûe uzywaê spakowanych plików z Kickstartem - w tym
  333. celu musisz zainstalowaê xfdmaster.library.
  334.  
  335. MAC - uûyj tej opcji, jeûeli korzystasz z programowego emulatora komputerów
  336. Macintosh. Spowoduje ona rezerwacjë pierwszych 16kB pamiëci chip, czego
  337. wymagajâ te programy. Nie musisz juû uûywaê programów typu RsrvCold, RsrvWarm
  338. czy PrepareEmul w swoim startup-sequence. Nie zapomnij wywoîaê programu "DRAP"
  339. zaraz po SetPatchu!
  340.  
  341. NF lub NOPAGEFIX - ta opcja ma sens tylko przy Kickstarcie 2.x; w wersjach 3.x
  342. jest ignorowana. Jest uûywana do wyîâczenia poprawki w systemie, dotyczâcej
  343. pierwszej strony pamiëci, a dokonywanej automatycznie przez remapera. Na
  344. Kickstartach 2.x pamiëê chip jest przyîâczana do systemu od lokacji $400.
  345. Poniewaû MMU procesorów 040 i 060 moûe pracowaê z najmniejszâ rozdzielczoôciâ
  346. 4kB, lepiej jest, aby pamiëê byîa odpowiednio do tego wyrównana (czyli
  347. zaczynaîa sië od adresu $1000). Aby tego dokonaê maper poprawia procedurë
  348. inicjalizacji systemu; poczâwszy od Kickstartu 3.x ta poprawka nie jest juû
  349. potrzebna. Jeôli z jakiegoô powodu nie chcesz zmieniaê oryginalnego zachowania
  350. sië systemu 2.x przy przyîâczaniu pamiëci chip uûyj opcji NOPAGEFIX. Parametr
  351. ten nic nie robi w przypadku uûycia opcji MAC.
  352.  
  353. FORCE - uûywany jeûeli relokacja jest juû aktywna i chcesz wymusiê ponowne
  354. uûycie mapera. Normalnie remaper nie bëdzie staraî sië dokonaê relokacji,
  355. jeôli stwierdzi takowâ w pamiëci (umoûliwia to stosowanie mapera w
  356. startup-sequence bez ciâgîych resetów komputera).
  357.  
  358. QUIET - idealna opcja dla chcâcych wykorzystywaê mapera na staîe (w
  359. startupie); powoduje wyîâczenie wypisywania tekstów i skraca oczekiwanie na
  360. reset komputera.
  361.  
  362. ---> Poczâwszy od wersji 1.2, zostaîa dodana nowa opcja: IMJ; jej podanie
  363. spowoduje, ûe maper bëdzie ignorowaî zworkë MEM, która umoûliwia odîâczenie
  364. pamiëci fast umieszczonej na karcie.
  365.  
  366. ---> Poczâwszy od wersji 1.6, zostaîa dodana nowa opcja: REBFIX; uûyj jej
  367. jeôli miaîeô problemy z poprawnym zgîaszaniem sie kart w slotach ZORROII. Ze
  368. wzglëdu na bîad karty Apollo, czasami wystëpujâ przekîamania w protokole
  369. AutoConfig(TM) - REBFIX stanowi próbë ich usuniëcia. Ze wzglëdu na
  370. eksperymentalny charakter uûytego w tym celu kodu, uûywaj tego przeîâcznika
  371. tylko jeôli bez niego któraô z kart sië nie zgîasza, bâdú zgîasza sië
  372. niepoprawnie.
  373.  
  374. O ile nie wybraîeô opcji QUIET, moûesz przerwaê proces mapowania wciskajâc
  375. jednoczeônie klawisze "control" i "c" (CTRL-C).
  376.  
  377. *****************************************************************************
  378. **** UWAGA! PONIÛSZY AKAPIT JEST PRZEZNACZONY DLA ZAAWANSOWANYCH! UWAGA! ****
  379. *****************************************************************************
  380.  
  381. ---> Poczâwszy od wersji 0.980ß, zostaîa dodana nowa opcja: MODULES
  382.  
  383. MODULES - ten parametr okreôla lokacjë plików, które majâ byê umieszczone w
  384. pamiëci jako rezydentne razem z mapowanym Kickstartem. Liczba tych plików jest
  385. ograniczona jedynie wielkoôciâ dostëpnej pamiëci (oraz maksymalnâ dîugoôciâ
  386. linii rozkazowej). Moduîem rezydentnym moûe byê kaûdy plik, który posiada
  387. strukturë resident (na przykîad biblioteka czy filesystem). Moûna teû
  388. skorzystaê z tej opcji, aby zaîadowaê IDEFix'a. Uwaga! - opcja ta MUSI byê
  389. podana jako *ostatnia* w linii rozkazowej!
  390.  
  391. Poczâwszy od wersji 0.996 moûliwe jest wykorzystanie moduîów doîâczanych do
  392. programu BlizKick! Moduîy te wystëpujâ w dwóch postaciach  - jako tzw. îatki
  393. (patch) lub jako rezydenty (extresbuf). Te pierwsze mogâ byê uûywane
  394. bezpoôrednio jak zwykîe moduîy, natomiast pozostaîe naleûy skonwertowaê. W tym
  395. celu uûyj doîâczonego programiku "Converter".
  396.  
  397. Od wersji 1.2 podawanie za kaûdym razem peînych ôcieûek do moduîów leûâcych w
  398. tym samym katalogu nie jest juû konieczne. Zaîóûmy, ûe chcesz zaîadowaê trzy
  399. moduîy z katalogu DEVS:Mods/. W starszych wersjach, naleûaîoby napisaê tak:
  400.  
  401. "...MODULES DEVS:Mods/noclick DEVS:Mods/FixMath404 DEVS:Mods/ramlibstack"
  402.  
  403. Poczâwszy od wersji 1.2 wystarczy podaê ôcieûkë tylko za pierwszym razem:
  404.  
  405. "RemAPollo MODULES DEVS:Mods/noclick FixMath404 ramlibstack"
  406.  
  407. ---> Poczâwszy od wersji 0.991ß, zostaîa dodana nowa opcja: USEKICKPTRS
  408.  
  409. USE (lub USEKICKPTRS) - ten parametr zmusza remapera do uûycia bieûâcej listy
  410. rezydentów KickTag i KickMem. Dziëki temu moûliwe jest uûycie innych programów
  411. rezydentnych wymagajâcych resetu, a mimo to nadal mieê tylko jeden reset na
  412. starcie. Aby to osiâgnâê, dodatkowe programy instalujâce sië rezydentnie
  413. powinny byê uruchomione PRZED remaperem i powinny mieê zablokowanâ opcje
  414. wykonania restartu komputera. Np. jeôli uûywasz programu BootControl,
  415. napisanego przez Olivera Kastla i chciaîbyô mieê tylko jeden reset na starcie,
  416. Twój startup powinien wyglâdaê tak:
  417.  
  418. BootControl INSTALL        ;UWAGA: nie uûywaj opcji BOOT!!!
  419. RemAPollo DEVS:Kick3.1 MAC QUIET USE    ;dziëki USE maper "widzi" BootControl
  420. SetPatch QUIET
  421. DRAP
  422. ...
  423.  
  424. Zwróê uwagë, ûe wszystkie programiki rezydentne zainstalowane w powyûszy
  425. sposób, zostanâ zaîadowane do pamiëci typu LOCAL, co na wiëkszoôci systemów
  426. oznacza chip. Aby to ominâê, napisaîem programik FakeLOCAL. Powinien on byê
  427. umieszczony jako pierwszy w startup-sequence - powyûszy przykîad bëdzie wiëc
  428. wyglâdaî nastëpujâco:
  429.  
  430. FakeLOCAL
  431. BootControl INSTALL        ;UWAGA: nie uûywaj opcji BOOT!!!
  432. RemAPollo DEVS:Kick3.1 MAC QUIET USE    ;dziëki USE maper "widzi" BootControl
  433. SetPatch QUIET
  434. DRAP
  435. ...
  436.  
  437. Teraz BootControl zostanie zaîadowany do pamiëci fast karty.
  438.  
  439. UWAGA: programik FakeLOCAL jest napisany niezgodnie z systemem (stanowi tzw.
  440. hack) i powinien byê wywoîywany tylko, jeôli przed resetem zostanie uûyty
  441. takûe RemAPollo! Jeôli nie rozumiesz znaczenia bitów LOCAL i KICK - lepiej nie
  442. uûywaj tego programiku!!!
  443.  
  444. *****************************************************************************
  445. *****************************************************************************
  446. *****************************************************************************
  447.  
  448.  
  449. Jeûeli potrzebny Ci przykîad, oto jak wyglâdajâ pierwsze linijki mojego
  450. startupu:
  451.  
  452. DRAP
  453. If WARN
  454. FakeLOCAL    ;uûywam tego TYLKO ze wzgîëdu na MountCD îadowany niûej!
  455. MountCD CD0 QUIET
  456. RemAPollo MAC QUIET USE MODULES C:IDEfix L:KingCON-handler FastFileSystem
  457. EndIf
  458. SetPatch QUIET
  459.  
  460. Mam Kickstart 3.1 w ROMie, wiëc nie muszë podawaê nazwy pliku. Jeôli uûywasz
  461. Kickstartu 3.0, powinieneô wpisaê coô w tym stylu:
  462.  
  463. RemAPollo DEVS:Kickstart3.1 MAC QUIET c:IDEFix l:FastFileSystem
  464.  
  465. Oczywiôcie, zakîadam ûe posiadasz odpowiedni plik w DEVS:.
  466.  
  467. Informacje dodatkowe
  468. --------------------
  469.  
  470. Rezydentny kod remapera jest zabezpieczony sumâ kontrolnâ aby zapewniê
  471. wîaôciwy start komputera - jeôli zostanie wykryta jakakolwiek zmiana w tym
  472. kodzie, program ustawi ekran na czerwono i zresetuje Amigë.
  473.  
  474. Maper korzysta z wektora ColdCapture, aby przetrwaê pomiëdzy resetami, wiëc
  475. nie powinieneô uûywaê ûadnych programów posîugujâcych sië nim. Dodatkowo jest
  476. równieû podmieniany wektor bus error procesora ($00000008) i powinien pozostaê
  477. niezmieniony, dopóki nie zostanie zainicjalizowana 040(060).library, co
  478. normalnie wykonuje SetPatch. Dopiero po tym powinieneô uruchomiê program DRAP,
  479. aby przywróciê oryginalnâ postaê tego wektora. Weú powyûsze pod uwagë podczas
  480. sprawdzania systemu programem antywirusowym.
  481.  
  482. Aby zmapowaê Kickstart, RemAPollo musi zbudowaê tabele MMU, co zajmuje pamiëê.
  483. Staraîem sië ograniczyê jej wielkoôê do niezbëdnego minimum, w zwiâzku z czym
  484. maper uûywa 8 kB tablic MMU. Niestety takie rozwiâzanie powoduje konflikt ze
  485. sposobem, w jaki biblioteki 040.library i 060.library instalujâ swoje 4 kB
  486. tablice. Nie wyîâczajâ one MMU przed zaîadowaniem tzw. root pointerów co
  487. prowadzi do nieprzewidywalnych reakcji systemu. Spójrz na odnoôny fragment
  488. kodu 040.library w wersji 37.30:
  489.  
  490. (wejôcie w të procedurë nastëpuje z wîâczonym MMU, ustawionym na tryb 8k)
  491.  
  492.     ori.w    #$700,SR
  493.     pflusha
  494.     move.l    (A0)+,D0
  495.     movec    D0,URP        ;!!! URP wskazuje na 4k tablice!!!
  496.     move.l    (A0)+,D0
  497.     movec    D0,SRP        ;!!! SRP wskazuje na 4k tablice!!! - BUUUM!
  498.     move.l    (A0)+,D0
  499.     movec    D0,TC        ;MMU zostaje przeîâczony na tryb 4k, trochë póúno...
  500.     pflusha
  501.     moveq    #0,D0
  502.     movec    D0,ITT0
  503.     movec    D0,ITT1
  504.     movec    D0,DTT0
  505.     movec    D0,DTT1
  506.     rte
  507.  
  508. Aby ta procedura dziaîaîa naleûy dodaê nastëpujâcy kod:
  509.  
  510.     ori.w    #$700,SR
  511.     moveq    #0,d0
  512.     movec    d0,TC        ;wyîâcz MMU
  513.     pflusha
  514.  
  515. ... i to wîaônie robi program "patch".
  516.  
  517. UWAGA: Jeûeli chcesz uûywaê Kickstartu z pliku, upewnij sië, ûe posiadasz
  518. wîaôciwâ jego wersjë, przystosowanâ do pracy z Twoim komputerem. Np. pliki
  519. Kickstartów, pochodzâce z A4000 (o wersjach 40.7x) nie bëdâ dziaîaîy poprawnie
  520. na A1200!
  521.  
  522.                                      ***
  523.  
  524. Uûytkownicy OS3.5/3.9, czytajcie:
  525.  
  526. Wielu z Was zapewne zastanawiaîo sië czy RemAPollo bëdzie wspóîpracowaî z
  527. systemem 3.5/3.9. Bez obaw: nie ma problemów. Wszystkie wersje pakietu sâ
  528. zgodne z nowymi aktualizacjami AmigaOS; nie powinno byê równieû problemów z
  529. ewentualnymi przyszîymi poprawkami systemu operacyjnego. Jednakûe nowsze
  530. wersje pakietu remapera idâ nieco dalej w uîatwieniach przy instalacji
  531. systemu 3.5/3.9. W tym celu zostaî doîâczony specjalny programik "RUX", który
  532. sîuûy do "wyciâgniëcia" rezydentnych modulow z pliku 'AmigaOS ROM Update'
  533. (znajdujâcego sië zwykle w DEVS:). Dziëki temu powodujâca drugi reset
  534. instalacja tych moduîów przez SetPatch, staje sië zbëdna. RUX reaguje na
  535. nastëpujâce parametry:
  536.  
  537. FILE,A600/S,A1200/S,A3000/S,A4000I/S,A4000S/S
  538.  
  539. FILE - wskazuje na plik 'AmigaOS ROM Update' (domyôlnie szukany w DEVS:)
  540.  
  541. Pozostaîe opcje okreôlajâ typ komputera, dla którego majâ byê przeznaczone
  542. "wyciâgane" moduîy:
  543.  
  544. A600 - raczej nie bëdziesz uûywaê tego przeîâcznika, gdyû "produkuje" on
  545.        moduîy przeznaczone dla procesora 68000
  546. A1200 - przewaûnie bëdziesz uûywaê tego
  547. A3000 - dla Amigi 3000
  548. A4000I - dla Amigi 4000 jeôli uûywasz tylko wbudowanego interfejsu IDE
  549. A4000S - dla Amigi 4000T z kontrolerem SCSI
  550.  
  551. Zatem po dokonanej instalacji przy uûyciu instalera z pîyty, moûesz dokonaê
  552. nastëpujâcych korekt:
  553.  
  554. 1. w katalogu LIBS: utwórz jakiô katalog (np. OS3.5)
  555. 2. przenieô z LIBS: do tego katalogu biblioteki workbench i icon
  556. 3. pamiëtaj aby usunâc te biblioteki z LIBS: (to waûne!)
  557. 4. zakîadajâc, ûe jesteô posiadaczem A1200, a plik "AmigaOS ROM Update"
  558. znajduje sië w DEVS:, otwórz okienko shella, zmieï katalog bieûâcy na
  559. LIBS:OS3.5/ i wpisz "RUX A1200"
  560. 5. stworzonych zostanie kilka plików o nazwach: OS_ModuleX, gdzie 'X' jest
  561. kolejnym numerem moduîu; sâ to rezydentne moduîy, które naleûy podaê przy
  562. opcji MODULES mapera. Jeôli chcesz znaê prawdziwâ nazwë danego pliku zajrzyj
  563. do jego komentarza
  564. 6. usuï plik "AmigaOS ROM Update" z DEVS: (zalecane) lub uûyj opcji
  565. NOROMUPDATE SetPatcha
  566.  
  567. Poczâtek Twojego startup-sequence powinien przypominaê coô takiego (oczywiôcie
  568. dostosuj to do swojej konfiguracji i upodobaï):
  569.  
  570. DRAP
  571. If WARN
  572. ;--------- to poniûej oczywiôcie w jednej linii
  573. RemAPollo DEVS:Kick3.1 MAC QUIET MODULES LIBS:OS3.5/OS_Module1 OS_Module2
  574. OS_Module3 workbench.library icon.library
  575. ;---------
  576. EndIf
  577. SetPatch QUIET NOROMUPDATE
  578. ...
  579.  
  580. Zazwyczaj moûesz opuôciê pierwszy moduî (OS_Module1), a w przypadku, gdy
  581. uûywasz teû IDEfixa lub FastATA, rownieû opuôê scsi.device. Prawdziwâ nazwë i
  582. funkcjë danego moduîu moûesz odczytaê z jego komentarza.
  583.  
  584. Dziëki takiej instalacji, unikniesz dwukrotnego resetu przy "zimnym" starcie
  585. komputera.
  586.  
  587.                                      ***
  588.  
  589. Uûytkownicy mmu.library majâ teraz moûliwoôê peînego skorzystania z pakietu;
  590. w tym celu zostaîa zamieszczona komenda MuDRAP (bëdâca w fazie
  591. eksperymentalnej). Jeôli ktoô chce uûywaê biblioteki 68040/060 doîâczonej do
  592. pakietu mmu.library musi zastâpiê zwykîâ komendë DRAP jej odpowiednikiem,
  593. czyli MuDRAP. Ze wzglëdu na sposób pracy mmu.library, instalacja RemAPollo
  594. jest nieco inna, niû opisana wyûej. RemAPollo powinien byê umieszczony PRZED
  595. komendami SetPatch i MuDRAP, a MuDRAP musi byê uruchomiony zaraz PO SetPatchu:
  596.  
  597. ... RemAPollo <opcje>
  598. SetPatch
  599. MuDRAP <opcje>
  600.  ...
  601.  
  602. Nie naleûy uûywaê programiku 'patch' na bibliotece 68040/060 z pakietu
  603. mmu.library!
  604.  
  605. UWAGA!: Doîâczona komenda MuDRAP ma charakter wysoce eksperymentalny i powinna
  606. byê uûyta TYLKO z bibliotekâ 68040/060 z pakietu mmu.library!!! Efekty uûycia
  607. komendy MuDRAP z innymi wersjami biblioteki 68040/060 nie sâ do koïca
  608. zdefiniowane!!!
  609.  
  610.                                      ***
  611.  
  612. Bîëdy
  613. -----
  614.  
  615. Ramdysk sterowany przez statram.device (SDx:) nie bëdzie pracowaî poprawnie na
  616. domyôlnej konfiguracji pakietu RemAPollo. Aby to zmieniê, wywoîaj DRAPa z
  617. opcjâ "ND". Uwaga ta nie dotyczy tych, którzy posiadajâ dwa, przyîâczane
  618. oddzielnie, banki pamiëci fast na karcie oraz wykorzystujâ RemAPollo >1.4.
  619.  
  620. OXYPatcher nie instaluje poprawnie swojego portu na wiëkszoôci systemów. Nie
  621. jest to moja wina - OXYPatcher jest úle napisany.
  622.  
  623. Poczâwszy od wersji 119.11 (3.1) programu IDEfix, autor zmieniî koncepjë
  624. zapisu preferencji. Sâ one teraz zapisywane do osobnego pliku, co sprawia, ûe
  625. îadujâc IDEfixa opcjâ MODULES, przestaje on widzieê swoje preferencje. Uûyj
  626. programiku CopyIDEfixPrefs, aby zapisaê preferencje wewnâtrz IDEfixa.
  627.  
  628. Otrzymaîem kilka raportów wskazujâcych na problemy z pewnymi starszymi grami
  629. na systemie z aktywnym RemAPollo. Dotyczyîo to gîównie tzw. gier NDOS, które
  630. sâ obecnie licznie "fixowane" do pracy z lepszymi procesorami i wyposaûane w
  631. loadery z twardego dysku. Próba uruchomienia niektórych gier tego typu
  632. owocowaîa problemami z grafikâ lub wrëcz powodowaîa zawieszenie sië komputera.
  633. Powyûsza sytuacja byîa spowodowana przez programik DRAP, który domyôlnie
  634. przenosiî tzw. stronë zerowâ pamiëci chip (pierwsze 4 lub 16kb w przypadku
  635. uûycia opcji MAC) do szybkiej pamiëci karty. Mówiâc szczerze, nie powinno to
  636. powodowaê ûadnych problemów, poniewaû kaûdy program napisany zgodnie z
  637. wytycznymi byîego Commodore, nie powinien uûywaê niezaalokowanej pamiëci.
  638. Niestety, w praktyce róûnie to bywa - dlatego postanowiîem zmieniê nieco
  639. sposób przeprowadzenia tego mapowania. Najpierw spróbuj pracy z nowym DRAPem,
  640. a jeôli to nie pomoûe, uûyj jego nowej opcji NR (NOREMAP), która spowoduje
  641. caîkowite wyîaczenie przenoszenia pierwszej strony chipu do fastu. Zwróê
  642. jednak uwagë, ûe po uûyciu Fusiona (emulatora Macintosha na Amigë) znów
  643. bëdziesz miaî te same problemy z uruchomieniem tych starych gier, poniewaû
  644. Fusion wykonuje to mapowanie we wîasnym zakresie. Dotyczy to tak pracy z
  645. RemAPollo jak i bez niego.
  646.  
  647.  
  648. Historia
  649. --------
  650.  
  651. V0.1ALFA - (??.9.98) - wersje wewnëtrzne tylko do wîasnego uûytku
  652.  
  653. V0.96ß - (23.12.98) - pierwsza wersja semi-publiczna (dla wybranych testerów)
  654.  
  655. V0.97ß - (1.1.99) zmiany:
  656.  - cache procesora sâ inwalidowane przed wîâczeniem
  657.  - wîâczany jest tylko cache dla instrukcji
  658.  - kod rezydentny sprawdza teraz sumë kontrolnâ Kickstartu (jeôli
  659.    nieprawidîowa, komputer jest resetowany z usuniëciem mapera z pamiëci)
  660.  
  661. V0.973ß - (8.1.99)
  662.  - poprawione rozpoznawanie przez Kickstart pamiëci tzw. slow ($c00000); to
  663.    powino wyeliminowaê zawieszanie sië mapera na niektórych systemach. Dziëki
  664.    dla Arkadiusza Winiarka i Marcina Ostrowskiego za zwrócenie uwagi na ten
  665.    problem.
  666.  
  667. V0.974ß - (12.1.99)
  668.  - po wykryciu procesora 68060, maper ustawia odpowiedniâ flage w strukturze
  669.    biblioteki exec.
  670.  
  671. V0.975ß - (13.1.99)
  672.  - inteligentniejsze rozpoznawanie relokacji przez maper, dziëki czemu moûna
  673.    uûywaê niektórych (dobrze napisanych) programów, które wykorzystujâ wektor
  674.    coldcapture. Pierwsza wersja publiczna.
  675.  
  676. V0.976ß - (26.1.99)
  677.  - zmiana nagîówka mapowanego Kickstartu na 'MM', w celu unikniëcia problemów
  678.    przy próbie ponownego jego zmapowania (RemAPollo dokonuje pewnych zmian w
  679.    obrazie Kickstartu).
  680.  
  681. V0.977ß - (28.1.99)
  682.  - poprawiony bîâd w procedurze resetujâcej.
  683.  
  684. V0.980ß - (1.2.99)
  685.  - dodana moûliwoôê îadowania rezydentnych moduîów (IDEFix, pliki beta od
  686.    Amigi International) razem z Kickstartem.
  687.  
  688. V0.981ß - (4.2.99)
  689.  - usuniëte bîëdy w procedurze alokacji przy opcji MODULES
  690.  
  691. V0.982ß - (5.2.99)
  692.  - maper sprawdza teraz czy nie sa podane te same moduly kilkakrotnie
  693.  - kilka zmian wewnëtrznych
  694.  - dodano nowe pliki do pakietu: LoadResident i KReader
  695.  
  696. Pozostaîa czëôê loga w wersji angielskiej instrukcji.
  697.  
  698. Podziëkowania
  699. -------------
  700.  
  701. Wielkie dziëki Harremu Sintonenowi, który przesîaî mi kilka wstëpnych
  702. informacji dotyczâcych MMU procesora 040. Byîo to dawno temu, ale pomogîy mi
  703. one rozpoznaê problem, z którym zamierzaîem sië zmierzyê.
  704.  
  705. Ciepîe buziaczki dla firmy Motorola ;-) za znakomity dziaî dystrybucji
  706. literatury, który zapewnia wszystkim chëtnym dostëp do szerokiego wyboru
  707. drukowanych materiaîów; a wszystko to caîkowicie za darmo!
  708.  
  709. Wreszcie dziëki wszystkim alfatesterom, którzy zgodzili sië ryzykowaê
  710. stabilnoôê swych systemów, zmagajâc sië z licznymi wresjami pakietu RemAPollo
  711. (szczególnie dziëkujë Marcinowi Ostrowskiemu, który pomógî mi namierzyê bardzo
  712. powaûny bîâd; mam nadziejë, ûe uda Ci sië w koïcu opanowaê system... ;)
  713.  
  714. Specjalne podziëkowania dla Oliviera Fabre za bugreporty i wytrwaîoôê w
  715. testowaniu programu na 68060.
  716.  
  717. Bardzo specjalne podziëkowania dla Hagena Hagemanna za pomoc. :-)
  718.  
  719. Podziëkowania dla Rafaîa Mroûkiewicza i Thomasa Richtera, którzy pomogli mi
  720. zdaê sobie sprawë, ûe zasady budowania tablic dla procesora 68060 róûniâ sië
  721. jednak znacznie w porównaniu z 68040.
  722.  
  723. Mojemu bratu Jackowi za niniejsze tîumaczenie.
  724.  
  725. Ten program dedykujë Ministry - zespoîowi tworzâcemu muzykë, nie wszechobecne
  726. g...no, jakim jest rap.
  727.  
  728. Autor
  729. -----
  730. Mój adres e-mail (preferowana forma kontaktu): bloelle@priv.gold.pl lub
  731. bloelle@polbox.com
  732.  
  733.  
  734. Mam nadziejë, ûe ten program przyda Ci sië. Baw sië dobrze!
  735.                                                             Mikoîaj.
  736.  
  737.       ------------> AMIGA - NAJLEPSZY KOMPUTER POD SÎOÏCEM <------------
  738.